home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ditroff.man < prev    next >
Encoding:
Text File  |  1990-07-21  |  9.3 KB  |  331 lines
  1.  
  2.  
  3.  
  4. DITROFF                   User Commands                   DITROFF
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      ditroff - text formatting and typesetting
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ddiittrrooffff [ option ] ...  [ file ] ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _D_i_t_r_o_f_f formats text in the named _f_i_l_e_s for printing on the
  16.      printer selected.  Different output devices may be selected
  17.      with the environment variables TYPESETTER and PRINTER or
  18.      with the -P option.  Output will be processed as specified
  19.      in the _d_i_t_c_a_p file, for the particular printer selected.
  20.      The companion preprocessors, pic, ideal, deqn, tbl and grn
  21.      all accept the TYPESETTER and PRINTER environment variables,
  22.      have the -P option, and access the ditcap file.   _T_r_o_f_f''ss
  23.      capabilities are described in the _N_r_o_f_f/_T_r_o_f_f _u_s_e_r'_s _m_a_n_u_a_l.
  24.  
  25.      It is a good idea to specify a printer using one of the
  26.      environment variables (PRINTER or TYPESETTER), or by using
  27.      the --PP_p_r_i_n_t_e_r option for ditroff and each of its preproces-
  28.      sors.  This is advisable since each preprocessor selects a
  29.      different default device if none is specified.  The device
  30.      independent troff (troff_p) and its associated preprocessors
  31.      (eqn, grn, tbl, ideal, pic,  ...) access the environment
  32.      variables (TYPESETTER and PRINTER), support the --PP_p_r_i_n_t_e_r
  33.      option, and access the _d_i_t_c_a_p file when processing troff
  34.      files.
  35.  
  36.      If no _f_i_l_e argument is present, the standard input is read.
  37.      An argument consisting of a single minus (--) is taken to be
  38.      a file name corresponding to the standard input.  The
  39.      options are:
  40.  
  41.      Troff options:
  42.  
  43.      --PP_d_e_v   Prepare output for typesetter _d_e_v.  If no printer is
  44.              specified, the default is the Laser Writer (lw).
  45.              The environment variable PRINTER will override the
  46.              default, and the environment variable TYPESETTER
  47.              overrides PRINTER.  A -P option will override all
  48.              else.  The _d_i_t_c_a_p file is searched for this printer,
  49.              and the printer type and other options are set from
  50.              this file.
  51.  
  52.      --TT_t_y_p   Change the printer type to _t_y_p , and don't read the
  53.              printer type from the ditcap file.
  54.  
  55.      --FF_d_i_r   Use font directory _d_i_r instead of
  56.              /sprite/lib/ditroff.  This overrides the (fd)
  57.              characteristic if it is set in the _d_i_t_c_a_p file.
  58.  
  59.      --DD_e_n_t   Use the ditcap entry for _e_n_t , rather than the
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DITROFF                   User Commands                   DITROFF
  71.  
  72.  
  73.  
  74.              ditcap entry for _d_e_v . Thus the ditcap characteris-
  75.              tics are read from the ditcap entry _e_n_t , and the
  76.              output is sent to _d_e_v .
  77.  
  78.      --tt      Send the troff_p output to standard output.  If the
  79.              (ft) characteristic is set in the ditcap file, then
  80.              pass the output through this filter before sending
  81.              it to standard output.
  82.  
  83.      --aa      Send a printable ASCII approximation of the results
  84.              to the standard output.  If the (fa) characteristic
  85.              is set in the ditcap file, then pass the output
  86.              through this filter before sending it to standard
  87.              output.
  88.  
  89.      --oo_l_i_s_t  Print only pages whose page numbers appear in the
  90.              comma-separated _l_i_s_t of numbers and ranges.  A range
  91.              _N--_M means pages _N through _M; an initial -_N means
  92.              from the beginning to page _N; and a final _N- means
  93.              from _N to the end.
  94.  
  95.      --nn_N     Number first generated page _N.
  96.  
  97.      --mm_n_a_m_e  Prepend the macro file //sspprriittee//lliibb//ddiittrrooffff//ttmmaacc.._n_a_m_e
  98.              to the input _f_i_l_e_s.
  99.  
  100.      --rr_a_N    Set register _a (one-character) to _N.
  101.  
  102.      --ii      Read standard input after the input files are
  103.              exhausted.
  104.  
  105.      --qq      Disable echoing during a ..rrdd request.
  106.  
  107.      --ddeebbuugg  Print the lines that ditroff would run, rather than
  108.              making system calls.
  109.  
  110.      Preprocessing options:
  111.  
  112.      --ttbbll   Pipe through tbl.
  113.  
  114.      --eeqqnn   Pipe through eqn.
  115.  
  116.      --sseeqqnn  Pipe through eqn using the special characters (in
  117.             /sprite/lib/ditroff/eqnxxxxx).
  118.  
  119.      --ggrrnn   Pipe through grn.
  120.  
  121.      --ppiicc   Pipe through pic.
  122.  
  123.      --rreeffeerr Pipe through refer.
  124.  
  125.      --iiddeeaall Pipe through ideal.
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DITROFF                   User Commands                   DITROFF
  137.  
  138.  
  139.  
  140.      Spooling options:
  141.  
  142.      --hh     Don't print the burst page.
  143.  
  144.      --mm     Send mail upon completion of the printing job.
  145.  
  146.      --CC_n_a_m_e Set the classname on the burst page to _n_a_m_e .
  147.  
  148.      --JJ_n_a_m_e Set the jobname on the burst page to _n_a_m_e .
  149.  
  150.      --##_N    Print _N copies of the job.
  151.  
  152.      Some options of _t_r_o_f_f only apply if you have a C/A/T
  153.      typesetter attached to your system.  These options are here
  154.      for historical reasons:
  155.  
  156.      --ss_N  Stop every _N pages.  _t_r_o_f_f stops the phototypesetter
  157.           every _N pages, produces a trailer to allow changing
  158.           cassettes, and resumes when the typesetter's start but-
  159.           ton is pressed.
  160.  
  161.      --ff   Refrain from feeding out paper and stopping photo-
  162.           typesetter at the end of the run.
  163.  
  164.      --ww   Wait until phototypesetter is available, if currently
  165.           busy.
  166.  
  167.      --bb   Report whether the phototypesetter is busy or avail-
  168.           able.  No text processing is done.
  169.  
  170.      --ppN  Print all characters in point size _N while retaining
  171.           all prescribed spacings and motions, to reduce photo-
  172.           typesetter elapsed time.
  173.  
  174. PPRROOCCEESSSSIINNGG
  175.      The following details are only important to the user who
  176.      wants to set the environment variable DITCAP and change
  177.      ditcap entries.
  178.      The details of how files are processed is as follows:
  179.      ( (xx) indicates ditcap characteristics and [ ] indicates
  180.      optional parts )
  181.  
  182.      First all files are run through the preprocessors specified.
  183.      (we show all preprocessors, but only a few would be used
  184.      together) The first processor receives all the files as
  185.      input - note that this could be troff_p.  This part of the
  186.      command line is assembled as follows.
  187.  
  188.        PRE = refer SFILES | tbl | grn TYFT | \
  189.              pic TYFT | ideal TYFT | eqn TYFT |
  190.  
  191.            Where SFILES = "[(se)] files" the (se) string being
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DITROFF                   User Commands                   DITROFF
  203.  
  204.  
  205.  
  206.            prepended if the --sseeqqnn option is selected and if the
  207.            (se) characteristic is specified in the ditcap file.
  208.            And TYFT = " -T _t_y_p [-F _d_i_r ] " _t_y_p is either speci-
  209.            fied in the ditcap file (ty), or using the --TT option;
  210.            _d_i_r is used if it is specified by the -_F option or if
  211.            the (fd) characteristic is specified in the ditcap
  212.            file.
  213.  
  214.      NOTE:  The preprocessors above and troff_p below would be
  215.             the default ones given in the ditcap(5) documenta-
  216.             tion, unless appropriate ditcap characteristic are
  217.             specified in the ditcap file.
  218.  
  219.      I    Standard troff job directed to a printer (-a , -t
  220.           options not set)
  221.  
  222.           %  PRE  troff_p  TYFT  [(ol)] [troff options] \
  223.              [ | (f1) ] [ | (f2) ] [ | (f3) ] [ | (f4) ] \
  224.              | lpr -Pdev [spooling options] [(lo)]
  225.  
  226.      II   Using a previewer (as specified in the ditcap file)
  227.  
  228.           %  PRE  troff_p  TYFT  [(op)] [troff options] \
  229.              [ | (fp) ] > /tmp/dit$$
  230.  
  231.           %  (pv) /tmp/dit$$
  232.  
  233.           %  /bin/rm -f /tmp/dit$$
  234.  
  235.      III  Using the -t option
  236.  
  237.           %  PRE  troff_p TYFT  -t [(ot)] [troff options] \
  238.              [ | (ft) ] > standard output
  239.  
  240.      IV   Using the -a option
  241.  
  242.           %  PRE  troff_p TYFT  -a [(oa)] [troff options] \
  243.              [ | (fa) ] > standard output
  244.  
  245.  
  246.  
  247. FFIILLEESS
  248.      /sprite/lib/ditroff/ditcap  printer specific info
  249.      /sprite/lib/ditroff/tmac.*  standard macro files
  250.      /sprite/lib/ditroff/dev*    font width tables
  251.  
  252. BBUUGGSS
  253.      The --FF option is not very useful since the same directory
  254.      must be available on the machine that drives the printer.
  255.  
  256. SSEEEE AALLSSOO
  257.      ditcap(5)
  258.  
  259.  
  260.  
  261. Sprite v1.0                                                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. DITROFF                   User Commands                   DITROFF
  269.  
  270.  
  271.  
  272.      trchange(1) for a list of differences, in _d_i_t_r_o_f_f, to TROFF
  273.      commands
  274.      J. F. Ossanna, _N_r_o_f_f/_T_r_o_f_f _u_s_e_r'_s _m_a_n_u_a_l
  275.      B. W. Kernighan, _A _T_R_O_F_F _T_u_t_o_r_i_a_l
  276.      eqn(1), grn(1), ideal(1), pic(1), refer(1),
  277.      tbl(1), dterm(1), lpr(1), font(1)
  278.  
  279. AAUUTTHHOORR
  280.      Greg Heinzinger
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sprite v1.0                                                     5
  328.  
  329.  
  330.  
  331.